Communitygithub.com

ComeOnOliver/skillshub

Use ao implementar recursos do iOS 26 SwiftUI — cobre o sistema de design Liquid Glass, melhorias de desempenho, macro @Animatable, layout espacial 3D, ponte de cena, WebView/WebPage, edição de texto rico com AttributedString, aprimoramentos de arrastar e soltar e integração visionOS para iOS 26+

O que é skillshub?

Este skill fornece um guia abrangente sobre os novos recursos do SwiftUI para iOS 26, iPadOS 26, macOS Tahoe, watchOS 26 e visionOS 26. Ele aborda desde o sistema de design Liquid Glass até edição de texto rico, com foco em APIs específicas da WWDC 256 e melhorias de desempenho. É útil para desenvolvedores que desejam adotar o Liquid Glass, implementar edição de texto rico com AttributedString, incorporar conteúdo web com WebView, otimizar desempenho de listas e scroll, usar a macro @Animatable para animações customizadas, construir layouts espaciais 3D no visionOS, fazer ponte de cenas SwiftUI para UIKit/AppKit, implementar arrastar e soltar com múltiplos itens, e criar gráficos 3D com Chart3D. O skill inclui exemplos de código detalhados, dicas e orientações sobre requisitos de sistema, sendo compatível com todas as plataformas Apple mais recentes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-26-ref

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Recursos do SwiftUI 26

Visão Geral

Guia abrangente sobre os novos recursos do SwiftUI no iOS 26, iPadOS 26, macOS Tahoe, watchOS 26 e visionOS 26. Do sistema de design Liquid Glass à edição de texto rico, essas melhorias tornam o SwiftUI mais poderoso em todas as plataformas Apple.

Princípio central Desde melhorias de desempenho de baixo nível até os botões na sua interface de usuário, há grandes melhorias em todo o sistema.

Quando Usar Este Skill

  • Adotando o sistema de design Liquid Glass
  • Implementando edição de texto rico com AttributedString
  • Incorporando conteúdo web com WebView
  • Otimizando desempenho de lista e rolagem
  • Usando a macro @Animatable para animações customizadas
  • Construindo layouts espaciais 3D no visionOS
  • Fazendo ponte de cenas SwiftUI para UIKit/AppKit
  • Implementando arrastar e soltar com múltiplos itens
  • Criando gráficos 3D com Chart3D
  • Adicionando widgets ao visionOS ou CarPlay
  • Adicionando marcas de escala personalizadas a controles deslizantes (marcadores de capítulo, indicadores de valor)
  • Restringindo intervalos de seleção de controles deslizantes com enabledBounds
  • Personalizando a aparência de controles deslizantes (visibilidade do polegar, rótulos de valor atual)
  • Criando barras de área segura adesivas com efeitos de desfoque
  • Abrindo URLs no navegador do aplicativo
  • Usando botões de fechar e confirmar com estilo do sistema
  • Aplicando estilos de botão vítreo (iOS 26.1+)
  • Controlando o comportamento de dimensionamento de botões
  • Implementando barras de ferramentas de pesquisa compactas
  • Ajustando altura da linha ou espaçamento entre linhas base para texto

Requisitos de Sistema

iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+


Sistema de Design Liquid Glass

Para cobertura abrangente, veja axiom-liquid-glass (princípios de design, variantes, revisão de pressão) e axiom-liquid-glass-ref (guia de adoção em todo o aplicativo). Esta seção cobre apenas APIs específicas da WWDC 256.

Adoção Automática

Recompile com o SDK do iOS 26 — contêineres de navegação, barras de guias, barras de ferramentas, alternadores, seletores segmentados e controles deslizantes adotam automaticamente o novo design. Botões com borda assumem formato de cápsula por padrão. As planilhas ganham fundo Liquid Glass (remova qualquer personalização presentationBackground).

APIs de Barra de Ferramentas (iOS 26)

ToolbarSpacer

.toolbar {
    ToolbarItem(placement: .bottomBar) { Button("Arquivar", systemImage: "archivebox") { } }
    ToolbarSpacer(.flexible, placement: .bottomBar)  // Empurra itens para os lados
    ToolbarItem(placement: .bottomBar) { Button("Compor", systemImage: "square.and.pencil") { } }
}
// .fixed separa grupos visualmente; .flexible empurra para os lados (como Spacer em HStack)

ToolbarItemGroup (Agrupamento Visual)

Itens em um ToolbarItemGroup compartilham um único fundo vítreo "pill". ToolbarItemPlacement controla a aparência visual: confirmationAction → estilo glassProminent, cancellationAction → vidro padrão. Use .sharedBackgroundVisibility(.hidden) para excluir itens (por exemplo, avatares) do fundo do grupo.

Transformação de Barra de Ferramentas

Anexe .toolbar {} a visualizações individuais dentro de NavigationStack (não ao próprio NavigationStack). O iOS 26 transforma entre barras de ferramentas por visualização durante push/pop. Use toolbar(id:) com ToolbarItem(id:) correspondente entre telas para itens que devem permanecer estáveis (sem salto):

// MailboxList
.toolbar(id: "main") {
    ToolbarItem(id: "filter", placement: .bottomBar) { Button("Filtrar") { } }
    ToolbarSpacer(.flexible, placement: .bottomBar)
    ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nova Mensagem") { } }
}
// MessageList — "filter" ausente (anima para fora), "compose" permanece estável
.toolbar(id: "main") {
    ToolbarSpacer(.flexible, placement: .bottomBar)
    ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nova Mensagem") { } }
}

#1 pegadinha: Barra de ferramentas em NavigationStack = nada para transformar.

DefaultToolbarItem

Reposicione itens fornecidos pelo sistema (como pesquisa) dentro do layout da sua barra de ferramentas:

DefaultToolbarItem(kind: .search, placement: .bottomBar)
// Substitui o posicionamento padrão do sistema do tipo correspondente

Use em uma barra lateral NavigationSplitView recolhida para especificar qual coluna mostra a pesquisa no iPhone. Envolva em if #available(iOS 26.0, *) para compatibilidade reversa.

Barras de Ferramentas Personalizáveis pelo Usuário

toolbar(id:) permite personalização pelo usuário (reorganizar, mostrar/ocultar). Apenas itens .secondaryAction suportam personalização no iPadOS. Use showsByDefault: false para itens opcionais. Adicione ToolbarCommands() para item de menu no macOS.

Outros Recursos de Barra de Ferramentas

  • .navigationSubtitle("3 não lidas") — Linha secundária abaixo do título
  • .badge(3) em itens da barra de ferramentas — Contagens de notificação
  • Renderização de ícone monocromático — Reduz ruído visual; use matiz para significado, não para decoração
  • Desfoque de borda de rolagem — Automático, sem código necessário

Pesquisa Alinhada na Parte Inferior

APIs de pesquisa fundamentais: Veja axiom-swiftui-search-ref. Esta seção cobre apenas refinamentos do iOS 26.

NavigationSplitView {
    List { }.searchable(text: $searchText)
}
// Alinhado na parte inferior no iPhone, no topo à direita no iPad (automático)
// Use placement: .sidebar para restaurar a pesquisa incorporada na barra lateral no iPad
  • searchToolbarBehavior(.minimize) — Pesquisa compacta que expande ao tocar
  • Tab(role: .search) — Guia de pesquisa dedicada; campo de pesquisa substitui a barra de guias. Veja swiftui-nav-ref Seção 5.7

Efeito Vítreo para Visualizações Personalizadas

Button("Para o Topo", systemImage: "chevron.up") { scrollToTop() }
    .padding()
    .glassEffect()  // Adicione .interactive para controles personalizados no iOS
  • GlassEffectContainer — Necessário quando vários elementos vítreos estão próximos (vidro não pode amostrar vidro)
  • glassEffectID(_:in:) — Transições de transformação fluidas entre elementos vítreos usando um namespace
  • Transformação de planilha — Use .matchedTransitionSource + .navigationTransition(.zoom(...)) para transformar planilhas a partir de botões

Alterações em Botões e Controles

  • Forma de cápsula padrão para botões com borda (substitua com .buttonBorderShape(.roundedRectangle))
  • .controlSize(.extraLarge) — Novo tamanho de botão extra-grande
  • .controlSize(.small) em contêineres — Preserva densidade pré-iOS 26
  • GlassButtonStyle(.clear/.glass/.tint) — Variantes de botão vítreo (iOS 26.1+)
  • .buttonSizing(.fit/.stretch/.flexible) — Controla comportamento de layout do botão
  • Button(role: .close) / Button(role: .confirm) — Botões de fechar/confirmar com estilo do sistema
  • .clipShape(.rect(cornerRadius: 12, style: .containerConcentric)) — Concentricidade de canto
  • Menus: ícones na borda esquerda, consistente iOS/macOS

Melhorias em Controles Deslizantes

O iOS 26 adiciona marcas de escala personalizadas, intervalos de seleção restritos, rótulos de valor atual e controle de visibilidade do polegar.

Marcas de Escala em Controles Deslizantes

Tipos principais: SliderTick<V>, SliderTickContentForEach, SliderTickBuilder

// Marcas estáticas com rótulos
Slider(value: $value, in: 0...10) {
    Text("Avaliação")
} ticks: {
    SliderTick(0) { Text("Mín") }
    SliderTick(5) { Text("Méd") }
    SliderTick(10) { Text("Máx") }
}

// Marcas dinâmicas de uma coleção
SliderTickContentForEach(stops, id: \.self) { value in
    SliderTick(value) { Text("\(Int(value))°").font(.caption2) }
}

// Marcas baseadas em passo (chamado para cada valor de passo)
Slider(value: $volume, in: 0...10, step: 2, label: { Text("Volume") }, tick: { value in
    SliderTick(value) { Text("\(Int(value))") }
})

Restrição da API: SliderTickContentForEach requer que Data.Element corresponda ao tipo de valor SliderTick<V>. Para structs personalizadas, extraia valores numéricos: chapters.map(\.time) e depois procure rótulos via chapters.first(where: { $0.time == time }).

Controle Deslizante Completo

Slider(
    value: $rating, in: 0...100,
    neutralValue: 50,           // Ponto inicial / valor central
    enabledBounds: 20...80,     // Restringir intervalo selecionável
    label: { Text("Avaliação") },
    currentValueLabel: { Text("\(Int(rating))") },
    minimumValueLabel: { Text("0") },
    maximumValueLabel: { Text("100") },
    ticks: { SliderTick(50) { Text("Méd") } },
    onEditingChanged: { editing in print(editing ? "Iniciado" : "Finalizado") }
)

sliderThumbVisibility

.sliderThumbVisibility(.hidden) — Ocultar polegar para indicadores de progresso de mídia e UI mínima. Opções: .automatic, .visible, .hidden. Sempre visível no watchOS.


Novos Modificadores de Visualização

safeAreaBar

Barras adesivas com desfoque progressivo integrado:

List { ForEach(1...20, id: \.self) { Text("\($0). Item") } }
    .safeAreaBar(edge: .bottom) {
        Text("Barra de Ação Inferior").padding(.vertical, 15)
    }
    .scrollEdgeEffectStyle(.soft, for: .bottom) // ou .hard

Funciona como safeAreaInset mas com desfoque. A barra permanece fixa enquanto o conteúdo rola abaixo.

Melhoria em onOpenURL

@Environment(\.openURL) var openURL
// openURL(url, prefersInApp: true) — Abre em navegador no aplicativo estilo SFSafariViewController
// Link padrão abre no Safari; prefersInApp mantém os usuários no seu aplicativo

searchToolbarBehavior

Veja axiom-swiftui-search-ref para APIs .searchable fundamentais. O iOS 26 adiciona:

.searchable(text: $searchText)
.searchToolbarBehavior(.minimize)  // Botão compacto, expande ao tocar

Também: .searchPresentationToolbarBehavior(.avoidHidingContent) (iOS 17.1+) mantém o título visível durante a pesquisa.

Wrapper compatível reversamente para aplicativos que visam iOS 18+26:

extension View {
    @ViewBuilder func minimizedSearch() -> some View {
        if #available(iOS 26.0, *) {
            self.searchToolbarBehavior(.minimize)
        } else { self }
    }
}

// Uso
.searchable(text: $searchText)
.minimizedSearch()

Padrão de disponibilidade para itens de barra de ferramentas:

.toolbar {
    if #available(iOS 26.0, *) {
        DefaultToolbarItem(kind: .search, placement: .bottomBar)
        ToolbarSpacer(.flexible, placement: .bottomBar)
    }
    ToolbarItem(placement: .bottomBar) {
        NewNoteButton()
    }
}
.searchable(text: $searchText)

Funções de botão, GlassButtonStyle, buttonSizing — Veja a seção Sistema de Design Liquid Glass acima.

lineHeight (iOS 26)

Define a distância entre linhas de base do texto. Mais intuitivo que .lineSpacing() que mede do final de uma linha ao início da próxima.

Predefinições

Text("Lorem ipsum...")
    .lineHeight(.loose)     // Espaçamento aumentado para layouts abertos
    .lineHeight(.tight)     // Espaçamento reduzido para layouts compactos
    .lineHeight(.normal)    // Altura constante baseada em múltiplo do tamanho do ponto
    .lineHeight(.variable)  // Usa métricas de fonte para cálculo de altura

Controle Preciso

// Escala proporcionalmente ao tamanho da fonte
Text("Escala com tamanho do texto")
    .lineHeight(.multiple(factor: 2))

// Relativo ao tamanho do ponto com aumento fixo
Text("Relativo ao tamanho do ponto")
    .lineHeight(.leading(increase: 30))

// Valor fixo absoluto — NÃO escala com Dynamic Type
Text("Altura fixa")
    .lineHeight(.exact(points: 30))

Suporte a AttributedString

var s = AttributedString("Parágrafo\ncom várias\nlinhas.")
s.lineHeight = .exact(points: 32)
s.lineHeight = .multiple(factor: 2.5)
s.lineHeight = .loose

Comparação com APIs Existentes

APIMedeDisponível
.lineHeight()Linha de base a linha de baseiOS 26+
.lineSpacing()Final da linha ao início da próximaiOS 13+
.font(.body.leading(.tight))Predefinição de entrelinhamento no nível da fonteiOS 14+

Referência cruzada axiom-typography-ref — Sistema de tipografia completo incluindo Dynamic Type, tracking e internacionalização


Melhorias no iPad

Barra de Menu

Acesse ações comuns via menu deslizante para baixo

.commands {
    TextEditingCommands() // Mesma API da barra de menu do macOS

    CommandGroup(after: .newItem) {
        Button("Adicionar Nota") {
            addNote()
        }
        .keyboardShortcut("n", modifiers: [.command, .shift])
    }
}
// Cria barra de menu no iPad quando as pessoas deslizam para baixo

Janelas Redimensionáveis

Redimensionamento fluido no iPad

// MIGRAÇÃO NECESSÁRIA:
// Remova a chave de lista de propriedades obsoleta no iPadOS 26:
// UIRequiresFullscreen (chave inteira obsoleta, todos os valores)

// Para navegação em visualização dividida, o sistema mostra/oculta colunas automaticamente
// com base no espaço disponível durante o redimensionamento
NavigationSplitView {
    Sidebar()
} detail: {
    Detail()
}
// Adapta-se ao redimensionamento automaticamente

Referência "Eleve o design do seu aplicativo para iPad" (WWDC 2025)


Melhorias em Janelas no macOS

Animações de Redimensionamento de Janela Sincronizadas

.windowResizeAnchor(.topLeading) // Personalize onde a animação se origina

// O SwiftUI agora sincroniza a animação entre mudanças de tamanho da visualização de conteúdo
// e redimensionamento da janela - ótimo para preservar continuidade ao alternar guias

Melhorias de Desempenho

Desempenho de Lista (Foco no macOS)

Ganhos massivos para listas grandes

  • Carregamento 6x mais rápido para listas de 100.000+ itens no macOS
  • Atualizações 16x mais rápidas para listas grandes
  • Ganhos ainda maiores para listas maiores
  • Melhorias beneficiam todas as plataformas (iOS, iPadOS, watchOS)
List(trips) { trip in // 100k+ itens
    TripRow(trip: trip)
}
// Carrega 6x mais rápido, atualiza 16x mais rápido no macOS (iOS 26+)

Desempenho de Rolagem

Quadros perdidos reduzidos

O SwiftUI melhorou o agendamento de atualizações de interface do usuário no iOS e macOS. Isso melhora a capacidade de resposta e permite que o SwiftUI faça ainda mais trabalho para se preparar para quadros futuros. No geral, reduz a chance de seu aplicativo perder um quadro ao rolar rapidamente em altas taxas de quadros.

ScrollViews Aninhadas com Stacks Preguiçosos

Carrosséis de fotos e rolagem multieixo

ScrollView(.horizontal) {
    LazyHStack {
        ForEach(photoSets) { photoSet in
            ScrollView(.vertical) {
                LazyVStack {
                    ForEach(photoSet.photos) { photo in
                        PhotoView(photo: photo)
                    }
                }
            }
        }
    }
}
// ScrollViews aninhadas agora atrasam corretamente o carregamento com stacks preguiçosos
// Ótimo para construir carrosséis de fotos

Instrumento de Desempenho do SwiftUI

Nova ferramenta de perfilagem no Xcode

Faixas disponíveis:

  • Atualizações longas de corpo de visualização — Identifique cálculos caros de corpo
  • Atualizações de visualização da plataforma — Rastreie...

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas