Sayfalar, Sayfa Öğeleri ve Özellikler

Slaytlar API'sini etkili bir şekilde kullanmak için sunuların ve bileşenlerinin mimarisini, ayrıca bu bileşenler arasındaki etkileşimleri anlamanız gerekir. Bu sayfada aşağıdaki konularla ilgili ayrıntılı bir genel bakış sunulmaktadır:

  • Sunu bileşenlerinin kavramsal modeli
  • API bu bileşenleri nasıl temsil eder?
  • Bileşenlerin stil özellikleri

Bu ve diğer kavramlara genel bakışları okuyarak nasıl yapılır kılavuzlarını, referans dokümanlarını ve kod örneklerini daha kolay anlayıp kullanabilirsiniz.

Sunular, sayfalar ve sayfa öğeleri

Google Slaytlar'daki en dıştaki kapsayıcı öğe bir sunudur. Bu, Google Drive'a kaydedilebilen, diğer kullanıcılarla paylaşılabilen vb. birimdir.

Her sunumda çeşitli türlerde sayfalar bulunur. Bir sayfa türü de slayt olarak adlandırılır. Slaytlar, sunu bir ekranda oluşturulduğunda kullanıcıların gördüğü ve aralarında geçiş yaptığı sayfalardır.

Her sayfada, aşağıdaki diyagramda gösterildiği gibi, sayfanın içeriğini oluşturan bir dizi sayfa öğesi bulunur:

Slaytlar mimari şeması

Slaytların yanı sıra, tasarımları birçok farklı slayta uygulamanıza ve tutarlı bir görünüm oluşturmanıza olanak tanıyan başka sayfa türleri de vardır. Bu diğer sayfa türleri ana slaytlar ve düzenlerdir. Özellikleri, slaytların nasıl oluşturulacağını belirler. Bu durum aşağıdaki şemada gösterilmiştir:

Temalar mimari şeması

Ana sayfalar: Ana sayfa iki amaca hizmet eder. Ana slayttaki yer tutucular, sununuzda kullanılan metin stillerinin varsayılanlarını içerir. Ana slayttaki arka plan ve diğer şekiller, bu ana slayta dayalı tüm slaytların varsayılan arka planını oluşturur. Sununuzdaki her slaytta görünmesini istediğiniz bir şirket logonuz varsa bunu asıl slayda yerleştirin.

Düzenler: Düzen şablonları, içeriğin her slayt türünde nasıl düzenleneceğini belirler. Tüm başlık slaytlarınızın belirli bir şekilde görünmesini istiyorsanız örneğin başlık düzeni şablonunu düzenleyebilirsiniz.

Çoğunlukla konuşmacı notlarıyla çalışırken kullanılan iki sayfa türü daha vardır: not sayfaları ve not ana sayfaları.

API gösterim türleri ve yapısı

Bu bölümde, yukarıda açıklandığı gibi Google Slaytlar kavramsal modelinin Slaytlar API'sinde nasıl temsil edildiği açıklanmaktadır.

Aşağıdaki şemada, Slaytlar API'sindeki türler olarak sunular, sayfalar ve sayfa öğeleri arasındaki ilişki gösterilmektedir:

ERD tarzı diyagram

Aşağıdaki bölümlerde bu türlerin JSON'da nasıl gösterildiği açıklanmaktadır.

Sunular

Sunu, bir dizi özellik içerir ve içindeki sayfaları barındırır:

{
  "presentationId": string,
  "pageSize": { object(Size) },
  "slides": [ { object(Page) } ],
  "title": string,
  "masters": [ { object(Page) } ],
  "layouts": [ { object(Page) } ],
  "notesMaster": object(Page),
  "locale": string,
}

Pages

Bir sayfa, bir dizi özellik içerir ve sayfadaki öğeleri barındırır:

{
  "objectId": string,
  "pageType": enum(PageType),
  "pageElements": [ { object(PageElement) } ],
  "pageProperties": { object(PageProperties) },

  // Union field properties can be only one of the following:
  "slideProperties": { object(SlideProperties) },
  "layoutProperties": { object(LayoutProperties) },
  "notesProperties": { object(NotesProperties) },
  // End of list of possible types for union field properties.
}

Sayfa öğeleri

Sayfa öğeleri, sayfalara yerleştirilen görsel bileşenlerdir. API'deki bir sayfa öğesi, sayfa öğesinin türüne göre değişen bir alan da dahil olmak üzere çeşitli özellikler içerir:

{
  "objectId": string,
  "size": { object(Size) },
  "transform": { object(AffineTransform) },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": { object(Group) },
  "shape": { object(Shape) },
  "image": { object(Image) },
  "video": { object(Video) },
  "line": { object(Line) },
  "table": { object(Table) },
  "wordArt": { object(WordArt) },
  "sheetsChart": { object(SheetsChart) },
  // End of list of possible types for union field element_kind.
}

Yukarıdaki tanımda birleşim alanı element_kind ile tanımlandığı gibi, çeşitli sayfa öğesi türleri vardır. Bu tür sayfa öğeleri aşağıdaki tabloda açıklanmıştır:

Öğe türü Açıklama
Grup Tek bir birim olarak ele alınan bir grup sayfa öğesi. Bunlar birlikte taşınabilir, ölçeklendirilebilir ve döndürülebilir.
Şekil Dikdörtgenler, elipsler ve metin kutuları gibi düz görsel nesneler. Şekiller metin içerebilir. Bu nedenle, slayt oluşturmak için en sık kullanılan sayfa öğeleridir.
Resim Slaytlar'a aktarılmış bir grafik.
Video Slaytlar'a aktarılan bir video.
Çizgi Görsel bir çizgi, eğri veya bağlayıcı.
Tablo İçerik ızgarası.
WordArt Şekle daha çok benzeyen görsel bir metin öğesi.
SheetsChart Google E-Tablolar'dan Slaytlar'a aktarılan bir grafik.

Sayfa ve sayfa öğesi özellikleri

Slides API, sununuzdaki sayfaların ve sayfa öğelerinin görünümünü okumanıza ve güncellemenize olanak tanır. Farklı sayfa öğeleri, sayfa öğesinin nasıl oluşturulacağını kontrol eden farklı özellikleri destekler.

Her sayfa öğesi türünün karşılık gelen bir özellik öğesi ve özellik güncelleme mesajı vardır. Örneğin:

Her sayfa öğesi türü için aynı öğe/özellik/güncelleme isteği grubu bulunur: Image/imageProperties/UpdateImageProperties vb.

Özellikler özelliğini, bir öğeyi okurken karşılaştığınız her yerde okuyabilirsiniz. İçindeki değerleri değiştirmek için, batchUpdate yöntemi için yük olarak eşleşen istek türüyle birlikte kullanın. Böylece bu değerleri sunumda değiştirebilirsiniz.

Mülk türleri

Slaytlar API'sindeki çeşitli nesne türleri arasında ortak olan bazı özellikler vardır:

Mülk Açıklama
Renk Slides API'deki renkler RGB değeri veya tema rengine referans olabilir. Tema renkleri adlarıyla (örneğin, "DARK1") anılır ve sayfanın renk şeması kullanılarak RGB değerleriyle eşlenebilir. Bu renk şeması, Slaytlar düzenleyicisinde sununun teması değiştirilirken genellikle güncellenir.
Doldurma Dolgu, bir nesnenin içindeki boş alanın oluşturulmasını ifade eder. Slaytlarda en yaygın olarak desteklenen dolgu, nesnenin içinin tek bir düz renkle doldurulduğu düz dolgudur. Dolgu, sayfaların arka planları için de kullanılabilir.
Dış çizgi Ana hat, sayfa öğesini çevreleyen çizgiler kümesini temsil eder. Çizgilerin rengi dolguyla kontrol edilir. Arayanlar, ana hatların genişliğini ve çizgi stilini de ayarlayabilir.
Gölge Gölge, nesnenin oluşturduğu fiziksel gölgeyi taklit etmek için kullanılan bir görsel efekti temsil eder. Şu anda Slaytlar API'sindeki gölgeler salt okunurdur.

Özellikleri güncelleme

Bir mülkü güncellemek için uygun Update...Properties isteğini batchUpdate çağrısında kullanın. Örneğin, Şekiller için UpdateShapeProperties. Bu istekler, tam özellikler mesajını kabul eder ve özellikler mesajındaki hangi alanların güncelleneceğini belirlemek için alan maskelerini kullanabilir.

Mülkü devralma

Bir sayfa veya sayfa öğesi, özellikleri üst nesnelerinden devralabilir. Bir nesnenin tanımladığı ve devraldığı özellikler de dahil olmak üzere nesnenin özellikleri, son görsel görünümünü belirler.

  • Sayfa özellikleri: Bir sayfa, tanımlamadığı ancak dayandığı düzende veya ana öğede tanımlanan tüm özellikleri devralır.
  • Şekil özellikleri: Bir şekil, yer tutucu olarak işaretlenebilir. Bu sayede, özellikleri devralmak için başka bir yer tutucu şekle (sayfanın üst yerleşiminde veya ana düzeninde) açıkça referans verebilirsiniz.

Bu fikirler sonraki paragraflarda daha ayrıntılı olarak açıklanmaktadır.

Sayfa özelliklerinin devralınması

Slaytların, düzenlerin ve ana slaytların yapısı, sunum içinde bir devralma hiyerarşisi tanımlar: Slaytlar düzenlerden, düzenler ise ana slaytlardan devralınır. Bir slaytın üst yerleşimi ve ana slaytı, slaytın slideProperties alanında belirtilir.

Bir sayfa, üst sayfadan arka plan ve renk şeması gibi özellikleri devralabilir. Bir özelliği devralmak için alt sayfa, PageProperties mesajında bu özelliğe ait bir değer ayarlamaz. Sayfa, üst öğe tarafından tanımlanan değeri "geçersiz kılmadığı" için devralınan değeri kabul eder.

Aşağıdaki diyagramda, bir ana slayttan devralınan bir düzenden özellikleri devralan bir slayt gösterilmektedir:

slayt mülkünün devralınması

Bir slaytı oluşturmak için kullanılan özellikler, tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, 1. slaytı oluşturmak için kullanılan çözümlenmiş değerler şunlardır:

  • PropertyA, "Kırmızı"dır.
  • PropertyB, "Orange" değerine sahip.

Şekil özelliklerinin devralınması

Şekiller, dolgu, ana hat veya gölge gibi özellikleri diğer şekillerden devralabilir. Shape.placeholder alanı ayarlanmışsa şekil yer tutucudur. Alt yer tutucunun Shape.placeholder.parentObjectId alanı, üst yer tutucusunu tanımlar. Bir düzene dayalı yeni bir slayt oluşturduğunuzda, bu düzendeki tüm yer tutucular yeni slaytta alt şekiller olarak görünür. Benzer şekilde, ana sayfalardaki yer tutucular, düzenlerin yer tutucularının üst öğeleri olarak işlev görebilir.

Bu devralma hiyerarşisi tanımlandığında, alt sayfa bu değeri ShapeProperties mesajında ayarlamayarak bir özelliği devralır. Üst öğe tarafından tanımlanan değeri geçersiz kılmadığınızda alt şekil, devralınan değeri kabul eder.

Aşağıdaki diyagramda, bir slayt, düzen ve ana öğede bulunan üç yer tutucu arasındaki özelliklerin devralınması gösterilmektedir:

şekil özelliği devralma

Yer tutucu şekli oluşturmak için kullanılan özellikler, tanımladığı ve devraldığı özelliklerin bir kombinasyonudur. Bu örnekte, bu şekillerin çözümlenen değerleri aşağıdaki gibidir:

  • Yer tutucu 1: propertyA, "Sarı" olarak, propertyB ise "Yeşil" olarak oluşturulur.
  • Yer tutucu2: propertyA, "Sarı" olarak, propertyB ise "Mor" olarak oluşturulur.
  • Yer tutucu3: propertyA, "Sarı" olarak, propertyB ise "Mor" olarak oluşturulur.

Şekiller, üst öğelere sahip olabilen tek sayfa öğesi türüdür. Resim, tablo ve grafik gibi diğer türler yer tutucu olamaz ve üst öğeleri olamaz.

PropertyState kullanarak özellikleri "gizleme"

PropertyState numaralandırması, bir şeklin özelliğinin oluşturma için gerçekten kullanılıp kullanılmadığını veya değerin yalnızca alt şekiller tarafından devralma için kullanılıp kullanılmadığını kontrol eder. Mülk durumu NOT_RENDERED olan bir mülk, şekli sayfasında oluştururken kullanılmaz. Ancak karşılık gelen mülk durumu RENDERED olan alt öğeler bu mülkü devralmaya devam edebilir.

Aşağıdaki şemada, PropertyState alanını değiştiren üç yer tutucu arasındaki özelliklerin devralınması gösterilmektedir:

mülk durumu ve devralma

Şekil özelliklerinin oluşturulması, PropertyState alanından etkilenebilir. Bu örnekte, bu şekiller için çözümlenen değerler aşağıdaki gibidir:

  • Yer tutucu 1: propertyA, "Kırmızı" olarak oluşturulur.
  • Yer tutucu2: propertyA işlenmiyor. Bu, outline özelliği olsaydı Placeholder2'nin ana hattı olmazdı.
  • Yer tutucu3: propertyA işlenmiyor.

PropertyState numaralandırmasının bir olası değeri daha vardır: INHERIT özelliği durumu, özelliğin durumunun devralındığı ve üst öğenin değerinin kullanılması gerektiği anlamına gelir. Üst öğesi olmayan şekillerin INHERIT özellik durumu olamaz.