Skip to content

Commit

Permalink
Update the default sheet name in localization (#23)
Browse files Browse the repository at this point in the history
  • Loading branch information
@tianaiyouqing
tianaiyouqing authored Dec 12, 2023
1 parent 8ea0d8a commit 8ef2633
Show file tree
Hide file tree
Showing 24 changed files with 267 additions and 227 deletions.
64 changes: 34 additions & 30 deletions ar/cell.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -455,10 +455,10 @@ func (f *File) GetCols(sheet string, opts ...Options) ([][]string, error)

يحصل GetCols على قيمة جميع الخلايا حسب الأعمدة في ورقة العمل استنادًا إلى اسم ورقة العمل المحدد ، ويتم إرجاعه كمصفوفة ثنائية الأبعاد ، حيث يتم تحويل قيمة الخلية إلى نوع `string`. إذا كان من الممكن تطبيق تنسيق الخلية على قيمة الخلية ، فسيتم استخدام القيمة المطبقة ، وإلا سيتم استخدام القيمة الأصلية. فمثلا:

على سبيل المثال ، احصل على قيمة جميع الخلايا واجتيازها حسب الأعمدة في ورقة عمل تسمى `Sheet1`:
على سبيل المثال ، احصل على قيمة جميع الخلايا واجتيازها حسب الأعمدة في ورقة عمل تسمى `ورقة1`:

```go
cols, err := f.GetCols("Sheet1")
cols, err := f.GetCols("ورقة1")
if err != nil {
fmt.Println(err)
return
Expand All @@ -479,10 +479,10 @@ func (f *File) GetRows(sheet string, opts ...Options) ([][]string, error)

يُرجع GetRows كافة الصفوف في الورقة بواسطة اسم ورقة العمل المحدد ، ويتم إرجاعه كمصفوفة ثنائية الأبعاد ، حيث يتم تحويل قيمة الخلية إلى نوع `string`. إذا كان من الممكن تطبيق تنسيق الخلية على قيمة الخلية ، فسيتم استخدام القيمة المطبقة ، وإلا سيتم استخدام القيمة الأصلية. جلب GetRows الصفوف ذات القيمة أو خلايا الصيغة ، وسيتم تخطي الخلايا الفارغة باستمرار في ذيل كل صف ، لذلك قد يكون طول كل صف غير متسق.

على سبيل المثال ، احصل على قيمة جميع الخلايا واجتيازها حسب الصفوف في ورقة عمل تسمى `Sheet1`:
على سبيل المثال ، احصل على قيمة جميع الخلايا واجتيازها حسب الصفوف في ورقة عمل تسمى `ورقة1`:

```go
rows, err := f.GetRows("Sheet1")
rows, err := f.GetRows("ورقة1")
if err != nil {
fmt.Println(err)
return
Expand All @@ -503,10 +503,10 @@ func (f *File) GetCellHyperLink(sheet, cell string) (bool, string, error)

يحصل GetCellHyperLink على ارتباط تشعبي للخلية استنادًا إلى اسم ورقة العمل المحددة وإحداثيات الخلية. إذا كانت الخلية تحتوي على ارتباط تشعبي ، فستعرض `true` وعنوان الارتباط ، وإلا ستعرض `false` وعنوان ارتباط فارغًا.

على سبيل المثال ، احصل على ارتباط تشعبي لخلية `H6` في ورقة عمل باسم `Sheet1`:
على سبيل المثال ، احصل على ارتباط تشعبي لخلية `H6` في ورقة عمل باسم `ورقة1`:

```go
link, target, err := f.GetCellHyperLink("Sheet1", "H6")
link, target, err := f.GetCellHyperLink("ورقة1", "H6")
```

## الحصول على فهرس النمط {#GetCellStyle}
Expand All @@ -523,10 +523,10 @@ func (f *File) GetCellStyle(sheet, cell string) (int, error)
func (f *File) MergeCell(sheet, hCell, vCell string) error
```

دمج الخلايا بناءً على اسم ورقة العمل المحدد ومناطق إحداثيات الخلية. يؤدي دمج الخلايا إلى الاحتفاظ فقط بقيمة الخلية العلوية اليسرى ، ويتجاهل القيم الأخرى. على سبيل المثال ، ادمج الخلايا في منطقة `D3:E9` في ورقة عمل تسمى `Sheet1`:
دمج الخلايا بناءً على اسم ورقة العمل المحدد ومناطق إحداثيات الخلية. يؤدي دمج الخلايا إلى الاحتفاظ فقط بقيمة الخلية العلوية اليسرى ، ويتجاهل القيم الأخرى. على سبيل المثال ، ادمج الخلايا في منطقة `D3:E9` في ورقة عمل تسمى `ورقة1`:

```go
err := f.MergeCell("Sheet1", "D3", "E9")
err := f.MergeCell("ورقة1", "D3", "E9")
```

إذا تداخلت منطقة إحداثيات الخلية المحددة مع الخلايا المدمجة الأخرى الموجودة ، فسيتم حذف الخلايا المدمجة الحالية.
Expand All @@ -537,10 +537,10 @@ err := f.MergeCell("Sheet1", "D3", "E9")
func (f *File) UnmergeCell(sheet string, hCell, vCell string) error
```

يوفر UnmergeCell وظيفة لإلغاء دمج منطقة إحداثيات معينة. على سبيل المثال ، إلغاء دمج المنطقة `D3:E9` في `Sheet1`:
يوفر UnmergeCell وظيفة لإلغاء دمج منطقة إحداثيات معينة. على سبيل المثال ، إلغاء دمج المنطقة `D3:E9` في `ورقة1`:

```go
err := f.UnmergeCell("Sheet1", "D3", "E9")
err := f.UnmergeCell("ورقة1", "D3", "E9")
```

تنبيه: المناطق المتداخلة ستكون أيضًا غير مدمجة.
Expand Down Expand Up @@ -591,7 +591,7 @@ func (f *File) GetPictureCells(sheet string) ([]string, error)
func (f *File) AddComment(sheet string, comment Comment) error
```

يوفر AddComment طريقة لإضافة التعليقات في ورقة من خلال فهرس ورقة العمل والخلية ومجموعة التنسيق (مثل المؤلف والنص). لاحظ أن الحد الأقصى لطول المؤلف هو 255 والحد الأقصى لطول النص هو 32512. على سبيل المثال ، أضف تعليقًا في `Sheet1!$A$3`:
يوفر AddComment طريقة لإضافة التعليقات في ورقة من خلال فهرس ورقة العمل والخلية ومجموعة التنسيق (مثل المؤلف والنص). لاحظ أن الحد الأقصى لطول المؤلف هو 255 والحد الأقصى لطول النص هو 32512. على سبيل المثال ، أضف تعليقًا في `Sheet1!A3`:

<p align="center"><img width="613" src="./images/comment.png" alt="أضف تعليقًا إلى مستند Excel"></p>

Expand Down Expand Up @@ -620,10 +620,10 @@ func (f *File) GetComments(sheet string) ([]Comment, error)
func (f *File) DeleteComment(sheet, cell string) error
```

يوفر DeleteComment طريقة حذف تعليق في ورقة بواسطة ورقة عمل معينة. على سبيل المثال ، احذف التعليق في `Sheet1!$A$30`:
يوفر DeleteComment طريقة حذف تعليق في ورقة بواسطة ورقة عمل معينة. على سبيل المثال ، احذف التعليق في `ورقة1!A30`:

```go
err := f.DeleteComment("Sheet1", "A30")
err := f.DeleteComment("ورقة1", "A30")
```

## تعيين صيغة الخلية {#SetCellFormula}
Expand All @@ -634,49 +634,49 @@ func (f *File) SetCellFormula(sheet, cell, formula string, opts ...FormulaOpts)

يوفر SetCellFormula وظيفة لتعيين الصيغة على الخلية يتم أخذها وفقًا لاسم ورقة العمل المحدد وإعدادات صيغة الخلية. يمكن حساب نتيجة خلية الصيغة عند فتح ورقة العمل بواسطة تطبيق Office Excel أو يمكن أن تستخدم الدالة [CalcCellValue](cell.md#CalcCellValue) أيضاً الحصول على قيمة الخلية المحسوبة. إذا لم يقم تطبيق Excel بحساب الصيغة تلقائيًا عند فتح المصنف ، يرجى الاتصال بـ [UpdateLinkedValue](utils.md#UpdateLinkedValue) بعد تعيين وظائف صيغة الخلية.

- مثال 1 ، تعيين الصيغة العادية `=SUM(A1,B1)` للخلية `A3` على `Sheet1`:
- مثال 1 ، تعيين الصيغة العادية `=SUM(A1,B1)` للخلية `A3` على `ورقة1`:

```go
err := f.SetCellFormula("Sheet1", "A3", "=SUM(A1,B1)")
err := f.SetCellFormula("ورقة1", "A3", "=SUM(A1,B1)")
```

- مثال 2 ، تعيين صفيف ثابت عمودي أحادي الأبعاد (صفيف عمود) الصيغة `1;2;3` للخلية `A3` على `Sheet1`:
- مثال 2 ، تعيين صفيف ثابت عمودي أحادي الأبعاد (صفيف عمود) الصيغة `1;2;3` للخلية `A3` على `ورقة1`:

```go
err := f.SetCellFormula("Sheet1", "A3", "={1;2;3}")
err := f.SetCellFormula("ورقة1", "A3", "={1;2;3}")
```

- مثال 3 ، تعيين صفيف ثابت أفقي أحادي الأبعاد (صف صف الصفيف) الصيغة `"a","b","c"` للخلية `A3` على `Sheet1`:
- مثال 3 ، تعيين صفيف ثابت أفقي أحادي الأبعاد (صف صف الصفيف) الصيغة `"a","b","c"` للخلية `A3` على `ورقة1`:

```go
err := f.SetCellFormula("Sheet1", "A3", "={\"a\",\"b\",\"c\"}")
err := f.SetCellFormula("ورقة1", "A3", "={\"a\",\"b\",\"c\"}")
```

- مثال 4 ، تعيين صيغة صفيف ثابت ثنائي الأبعاد `{1,2;"a","b"}` للخلية `A3` على `Sheet1`:
- مثال 4 ، تعيين صيغة صفيف ثابت ثنائي الأبعاد `{1,2;"a","b"}` للخلية `A3` على `ورقة1`:

```go
formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Sheet1", "A3", "={1,2;\"a\",\"b\"}",
err := f.SetCellFormula("ورقة1", "A3", "={1,2;\"a\",\"b\"}",
excelize.FormulaOpts{Ref: &ref, Type: &formulaType})
```

- مثال 5 ، تعيين صيغة صفيف النطاق `A1:A2` للخلية `A3` على `Sheet1`:
- مثال 5 ، تعيين صيغة صفيف النطاق `A1:A2` للخلية `A3` على `ورقة1`:

```go
formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Sheet1", "A3", "=A1:A2",
err := f.SetCellFormula("ورقة1", "A3", "=A1:A2",
excelize.FormulaOpts{Ref: &ref, Type: &formulaType})
```

- مثال 6 ، قم بتعيين الصيغة المشتركة `=A1+B1` للخلايا `C1:C5` في `Sheet1` ، `C1` هي الخلية الرئيسية:
- مثال 6 ، قم بتعيين الصيغة المشتركة `=A1+B1` للخلايا `C1:C5` في `ورقة1` ، `C1` هي الخلية الرئيسية:

```go
formulaType, ref := excelize.STCellFormulaTypeShared, "C1:C5"
err := f.SetCellFormula("Sheet1", "C1", "=A1+B1",
err := f.SetCellFormula("ورقة1", "C1", "=A1+B1",
excelize.FormulaOpts{Ref: &ref, Type: &formulaType})
```

- مثال 7 ، تعيين صيغة الجدول `=SUM(Table1[[A]:[B]])` للخلية `C2` في `Sheet1`:
- مثال 7 ، تعيين صيغة الجدول `=SUM(Table1[[A]:[B]])` للخلية `C2` في `ورقة1`:

```go
package main
Expand All @@ -694,13 +694,17 @@ func main() {
fmt.Println(err)
}
}()
if err := f.SetSheetName("Sheet1", "ورقة1"); err != nil {
fmt.Println(err)
return
}
for idx, row := range [][]interface{}{{"A", "B", "C"}, {1, 2}} {
if err := f.SetSheetRow("Sheet1", fmt.Sprintf("A%d", idx+1), &row); err != nil {
if err := f.SetSheetRow("ورقة1", fmt.Sprintf("A%d", idx+1), &row); err != nil {
fmt.Println(err)
return
}
}
if err := f.AddTable("Sheet1",
if err := f.AddTable("ورقة1",
&excelize.Table{
Range: "A1:C2",
Name: "Table1",
Expand All @@ -710,12 +714,12 @@ func main() {
return
}
formulaType := excelize.STCellFormulaTypeDataTable
if err := f.SetCellFormula("Sheet1", "C2", "=SUM(Table1[[A]:[B]])",
if err := f.SetCellFormula("ورقة1", "C2", "=SUM(Table1[[A]:[B]])",
excelize.FormulaOpts{Type: &formulaType}); err != nil {
fmt.Println(err)
return
}
if err := f.SaveAs("Book1.xlsx"); err != nil {
if err := f.SaveAs("المصنف1.xlsx"); err != nil {
fmt.Println(err)
}
}
Expand Down
22 changes: 13 additions & 9 deletions ar/chart.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,10 @@ func main() {
fmt.Println(err)
}
}()
if err := f.SetSheetName("Sheet1", "ورقة1"); err != nil {
fmt.Println(err)
return
}
for idx, row := range [][]interface{}{
{nil, "تفاح", "برتقال", "كمثرى"},
{"صغير", 2, 3, 3},
Expand All @@ -194,24 +198,24 @@ func main() {
fmt.Println(err)
return
}
if err := f.SetSheetRow("Sheet1", cell, &row); err != nil {
if err := f.SetSheetRow("ورقة1", cell, &row); err != nil {
fmt.Println(err)
return
}
}
enable, disable := true, false
if err := f.SetSheetView("Sheet1", -1, &excelize.ViewOptions{
if err := f.SetSheetView("ورقة1", -1, &excelize.ViewOptions{
RightToLeft: &enable,
}); err != nil {
fmt.Println(err)
}
if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
if err := f.AddChart("ورقة1", "E1", &excelize.Chart{
Type: excelize.Col,
Series: []excelize.ChartSeries{
{
Name: "Sheet1!$A$2",
Categories: "Sheet1!$B$1:$D$1",
Values: "Sheet1!$B$2:$D$2",
Name: "ورقة1!$A$2",
Categories: "ورقة1!$B$1:$D$1",
Values: "ورقة1!$B$2:$D$2",
},
},
Format: excelize.GraphicOptions{
Expand Down Expand Up @@ -242,9 +246,9 @@ func main() {
Type: excelize.Line,
Series: []excelize.ChartSeries{
{
Name: "Sheet1!$A$4",
Categories: "Sheet1!$B$1:$D$1",
Values: "Sheet1!$B$4:$D$4",
Name: "ورقة1!$A$4",
Categories: "ورقة1!$B$1:$D$1",
Values: "ورقة1!$B$4:$D$4",
Marker: excelize.ChartMarker{
Symbol: "none", Size: 10,
},
Expand Down
4 changes: 2 additions & 2 deletions ar/pivot.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -120,8 +120,8 @@ func main() {
f.SetCellValue("Sheet1", fmt.Sprintf("E%d", row), region[rand.Intn(4)])
}
if err := f.AddPivotTable(&excelize.PivotTableOptions{
DataRange: "Sheet1!$A$1:$E$31",
PivotTableRange: "Sheet1!$G$2:$M$34",
DataRange: "Sheet1!A1:E31",
PivotTableRange: "Sheet1!G2:M34",
Rows: []excelize.PivotTableField{
{Data: "شهر", DefaultSubtotal: true}, {Data: "عام"}},
Filter: []excelize.PivotTableField{
Expand Down
Loading

0 comments on commit 8ef2633

Please sign in to comment.