Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

Şablonlardaki Listeler - Madde İşaretli ve Numaralı

Listeler, belgelerdeki bilgileri düzenlemek ve sunmak için temel yapılardır. PDF4meŞablon motoru, hem madde işaretli hem de numaralı liste oluşturmayı destekleyerek, veri kaynaklarınızdan gelen dinamik içerikle iyi yapılandırılmış, okunabilir belgeler oluşturmanıza olanak tanır.

Madde İşaretli Listeler​

Madde işaretli listeler oluşturmak için, madde işaretli paragrafların içine foreach döngüleri yerleştirin. Word şablon.

Temel Madde İşaretli Liste Sözdizimi​

Madde işaretli bir paragraf oluşturun WordArdından foreach döngüsünü ekleyin:

<<foreach [bullet in EmployeeNames]>><<[bullet.listFirstName]>> <<[bullet.listLastName]>> 
<</foreach>>

Başlıca Adımlar:

  1. İçinde WordMadde işaretli bir liste oluşturun (madde işaretli biçimlendirme kullanın)
  2. foreach döngüsünü ekleyin ve alanları birleştirin.
  3. Döngü, her öğe için madde işaretini tekrarlayacaktır.

Örnek: Çalışan İsim Listesi​

Şablon Tasarımı:

Employee Directory:
• <<foreach [bullet in EmployeeNames]>><<[bullet.listFirstName]>> <<[bullet.listLastName]>> 
<</foreach>>

Veri Kaynağı:

{
  "companyName": "PDF4me",  
  "EmployeeNames": [
    {
      "listFirstName": "Thomas",
      "listLastName": "Baskin"
    },
    {
      "listFirstName": "Jacob",
      "listLastName": "Gregory"
    },
    {
      "listFirstName": "John",
      "listLastName": "Doe"
    }
  ]
}

Oluşturulan Çıktı:

Employee Directory:
• Thomas Baskin
• Jacob Gregory
• John Doe

Numaralı Listeler​

Aynı foreach yaklaşımını kullanarak, ancak paragraf biçimlendirmesini numaralandırarak numaralı listeler oluşturun. Word.

Numaralı Liste Sözdizimi​

Numbered List - Instead of bullets, if you apply the syntax in a numbered paragraph format in Word, the list will be generated as a numbered list with automatic numbering.

Örnek: Görev Listesi​

Şablon:

Project Tasks:
1. <<foreach [task in tasks]>><<[task.name]>> - <<[task.status]>>
<</foreach>>

Veri:

{
  "tasks": [
    { "name": "Design mockups", "status": "Complete" },
    { "name": "Develop features", "status": "In Progress" },
    { "name": "Testing phase", "status": "Pending" }
  ]
}

Çıktı:

Project Tasks:
1. Design mockups - Complete
2. Develop features - In Progress
3. Testing phase - Pending

Çok Seviyeli Listeler​

İç içe foreach döngüleri kullanarak üst-alt ilişkileri olan hiyerarşik liste yapıları oluşturun.

İki Seviyeli Hiyerarşi Örneği​

Şablon Tasarımı:

<<foreach [manager in employees]>>Manager: <<[manager.listFirstName]>> <<[manager.listLastName]>>
    <<foreach [associate in manager.associates]>>Associate: <<[associate.name]>>
<</foreach>><</foreach>>

Önemli: İkinci seviye liste öğeleri girintili olmalıdır. Word Doğru hiyerarşik biçimlendirme oluşturmak için şablon.

Örnek: Organizasyonel Yapı​

Veri Yapısı:

{
  "companyName": "PDF4me",
  "employees": [
    {
      "listFirstName": "Christopher",
      "listLastName": "Nolan",
      "associates": [
        { "name": "Will Smith" },
        { "name": "Barry Allen" },
        { "name": "Oliver Queen" }
      ]
    },
    {
      "listFirstName": "Sarah",
      "listLastName": "Parker",
      "associates": []
    },
    {
      "listFirstName": "Justin",
      "listLastName": "Langer",
      "associates": [
        { "name": "Brad Pitt" },
        { "name": "John Smith" }
      ]
    }
  ]
}

Oluşturulan Çıktı:

• Manager: Christopher Nolan
    ○ Associate: Will Smith
    ○ Associate: Barry Allen
    ○ Associate: Oliver Queen
• Manager: Sarah Parker
• Manager: Justin Langer
    ○ Associate: Brad Pitt
    ○ Associate: John Smith

Boş Alt Listelerin İşlenmesi​

Alt listelerin boş olabileceği durumları ele almak için koşullu kontroller kullanın.

Koşullu Alt Liste​

Şablon:

<<foreach [manager in employees]>>Manager: <<[manager.listFirstName]>> <<[manager.listLastName]>>
    <<if [manager.associates.Any()]>>
    <<foreach [associate in manager.associates]>>Associate: <<[associate.name]>>
    <</foreach>>
    <<else>>
    No associates assigned
    <</if>>
<</foreach>>

Biçimlendirilmiş Liste Öğeleri​

Daha iyi bir sunum için liste öğelerinin içeriğine biçimlendirme uygulayın.

Örnek: Biçimlendirilmiş İsimler ve Tarihler​

Şablon:

• <<foreach [employee in employees]>><<[employee.name]:caps>> - Joined: <<[employee.joinDate]:"MMMM yyyy"]>>
<</foreach>>

Veri:

{
  "employees": [
    { "name": "john smith", "joinDate": "2020/03/15" },
    { "name": "jane doe", "joinDate": "2021/07/22" }
  ]
}

Çıktı:

• John Smith - Joined: March 2020
• Jane Doe - Joined: July 2021

Sıralı Listeler​

Numaralandırma yöntemlerini kullanarak belirli sıralarda listeler oluşturun.

Alfabetik Olarak Sıralanmış Liste​

Şablon:

• <<foreach [person in people.OrderBy(p => p.lastName)]>><<[person.lastName]>>, <<[person.firstName]>>
<</foreach>>

Birden Çok Özelliğe Göre Sıralanmış​

Şablon:

• <<foreach [emp in employees.OrderBy(e => e.department).ThenBy(e => e.name)]>><<[emp.name]>> - <<[emp.department]>>
<</foreach>>

Filtrelenmiş Listeler​

Yalnızca belirli kriterleri karşılayan öğeleri göster.

Koşullu Filtreleme​

Şablon:

Active Employees:
• <<foreach [emp in employees.Where(e => e.status == "Active")]>><<[emp.name]>>
<</foreach>>

Yaşa Dayalı Filtreleme​

Şablon:

Senior Team Members:
• <<foreach [person in team.Where(p => p.age > 50)]>><<[person.name]>> (Age: <<[person.age]>>)
<</foreach>>

Karışık Liste Türleri​

Aynı belge içinde farklı liste stillerini birleştirin.

Örnek: Projeye Genel Bakış​

Şablon:

Project Phases (Numbered):
1. <<foreach [phase in phases]>><<[phase.name]>>
<</foreach>>

Team Members (Bulleted):
• <<foreach [member in team]>><<[member.name]>> - <<[member.role]>>
<</foreach>>

Karmaşık Çok Seviyeli Örnekler​

Üç Seviyeli Hiyerarşi​

Şablon:

<<foreach [dept in departments]>>Department: <<[dept.name]>>
    <<foreach [team in dept.teams]>>Team: <<[team.name]>>
        <<foreach [member in team.members]>><<[member.name]>> - <<[member.position]>>
        <</foreach>>
    <</foreach>>
<</foreach>>

Bu şunları oluşturur:

  • Seviye 1: Departman (madde işaretli 1)
    • Seviye 2: Takım (madde işaretli 2. seviye)
      • Seviye 3: Üye (madde işaretli 3. seviye)

Liste Tasarımı Word Şablon​

Liste Biçimlendirmesini Ayarlama​

  1. Liste yapısı oluşturun - Kullanmak Word'ın yerleşik liste biçimlendirme araçları
  2. Madde işaretli stili seçin - Uygun madde işareti veya numaralandırma stilini seçin
  3. Girinti ayarı - Çok seviyeli listeler için girinti seviyelerini yapılandırın
  4. Birleştirme alanları ekle - foreach döngülerini ve birleştirme alanı sözdizimini ekleyin.
  5. Biçimlendirmeyi koruyun - Liste biçimlendirmesinin şablon metnine uygulandığından emin olun.

Girinti Seviyeleri​

Çok seviyeli listeler için:

  • Seviye 1: Girinti yok veya birinci seviye girinti
  • Seviye 2: Bir sekme veya girinti artışı
  • Seviye 3: İki sekme veya ikinci seviye girinti

Word Girinti seviyesine bağlı olarak madde işaretli/numaralı stillendirmeyi otomatik olarak yapar.

Pratik Uygulamalar​

Kullanım Durumu 1: Toplantı Gündemi​

Şablon:

Meeting Agenda - <<[meetingDate]:"MMMM dd, yyyy">>

1. <<foreach [item in agendaItems]>><<[item.title]>> (<<[item.duration]>> min)
<</foreach>>

Attendees:
• <<foreach [attendee in attendees]>><<[attendee.name]>> - <<[attendee.department]>>
<</foreach>>

Kullanım Durumu 2: Ürün Özellikleri​

Şablon:

<<[productName]>> Features:

• <<foreach [feature in features]>><<[feature.name]>> - <<[feature.description]>>
<</foreach>>

Technical Specifications:
1. <<foreach [spec in specifications]>><<[spec.parameter]>>: <<[spec.value]>>
<</foreach>>

Kullanım Durumu 3: Fatura Kalemleri​

Şablon:

Order Items:
<<foreach [item in orderItems]>>
<<[$index + 1]>>. <<[item.name]>> - Quantity: <<[item.qty]>> - Price: $<<[item.price]>>
<</foreach>>

Total Items: <<[orderItems.Count()]>>
Total Amount: $<<[orderItems.Sum(i => i.qty * i.price)]>>

En İyi Uygulamalar​

Liste Tasarımı​

  1. Tutarlı biçimlendirme - Benzer içerik türleri için aynı liste stilini kullanın.
  2. Uygun derinlik - Okunabilirliği artırmak için iç içe geçme seviyesini 3-4 ile sınırlayın.
  3. Mantıksal gruplandırma - Birbiriyle ilişkili öğeleri gruplandırın
  4. Açık hiyerarşi - Farklı seviyeler için farklı madde işaretli yazı tipleri kullanın.

Veri Yapısı​

  1. Temiz koleksiyonlar - Koleksiyonların geçerli ve eksiksiz veriler içerdiğinden emin olun.
  2. Tutarlı özellikler - Öğeler genelinde tutarlı özellik adları kullanın.
  3. Boş değerleri ele alın - Boş koleksiyonları kontrol edin Any()
  4. Uygun şekilde sıralayın - Verileri önceden sıralayın veya şablonlarda OrderBy kullanın.

Performans​

  1. Liste boyutunu sınırla - Çok uzun listeler için sayfalama özelliğini göz önünde bulundurun.
  2. Etkin bir şekilde filtreleyin - Mümkün olduğunda filtreleri veri kaynağında uygulayın.
  3. Karmaşık iç içe geçmeyi önleyin. - Derin iç içe yerleştirme işlem hızını etkileyebilir.

:::ipucu Liste Biçimlendirme Liste biçimlendirmesini (madde işaretleri, numaralar, girinti) doğrudan uygulayın. Word foreach döngülerini eklemeden önce şablonu düzenleyin. Şablon motoru, belirlediğiniz biçimlendirmeyi korur. Word.

:::