diff --git a/docs/angular/lifecycle.md b/docs/angular/lifecycle.md index 007cdd56667..85a76955693 100644 --- a/docs/angular/lifecycle.md +++ b/docs/angular/lifecycle.md @@ -13,7 +13,7 @@ sidebar_label: ライフサイクル このガイドでは、Ionic と Angular を使用して構築されたアプリでの Page Life Cycle のしくみについて説明します。（追記：Life Cycle とは、表示をはじめてから破棄するまでを指します。この間の特定のタイミングに設定されているイベントを Life Cycle Events といいます） -![Ionic life cycle events demo](/img/guides/lifecycle/ioniclifecycle.png) +![Flowchart illustrating the Ionic page life cycle events and their sequence.](/img/guides/lifecycle/ioniclifecycle.png 'Ionic Lifecycle Diagram') ## Angular の Life Cycle Events @@ -47,7 +47,7 @@ Angular の Life Cycle Events に加えて、Ionic Angular には、使用可能 `ionViewWillLeave` と `ionViewDidLeave` についてですが、 `ionViewWillLeave` は現在のページから離脱する処理がはじまる前に呼び出されますが、 `ionViewDidLeave` は新しいページに遷移する処理が成功してから呼び出されます (新しいページの `ionViewDidEnter` が発火した後になります)。 -![Ionic life cycle events demo](/img/guides/lifecycle/ioniclifecycle.gif) +![Animated GIF showing Ionic page life cycle events in a console log as a page transition occurs.](/img/guides/lifecycle/ioniclifecycle.gif 'Ionic Lifecycle Animation') ## Ionic が Page の Life をどのように処理するか diff --git a/docs/angular/your-first-app.md b/docs/angular/your-first-app.md index ae976bdaaaf..22a9b47a603 100644 --- a/docs/angular/your-first-app.md +++ b/docs/angular/your-first-app.md @@ -132,7 +132,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to transform into a Photo Gallery. The Ionic CLI features Live Reload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-cap-ng/email-photogallery.gif) +![Animated GIF showing the live reload feature in an Ionic app, with changes in code immediately updating the app in a web browser.](/img/guides/first-app-cap-ng/email-photogallery.gif 'Live Reload Feature in Ionic App') Open the photo-gallery app folder in your code editor of choice, then navigate to `/src/app/tab2/tab2.page.html`. We see: diff --git a/docs/angular/your-first-app/2-taking-photos.md b/docs/angular/your-first-app/2-taking-photos.md index 0d839b8e2f5..efaa4f38961 100644 --- a/docs/angular/your-first-app/2-taking-photos.md +++ b/docs/angular/your-first-app/2-taking-photos.md @@ -70,7 +70,7 @@ Then, open `tab2.page.html` and call the `addPhotoToGallery()` function when the Save the file, and if it's not running already, restart the development server in your browser by running `ionic serve`. On the Photo Gallery tab, click the Camera button. If your computer has a webcam of any sort, a modal window appears. Take a selfie! -![Camera API on the web](/img/guides/first-app-cap-ng/camera-web.png) +![A photo gallery app displaying a webcam selfie.](/img/guides/first-app-cap-ng/camera-web.png 'Webcam Selfie in Photo Gallery') _(Your selfie is probably much better than mine)_ diff --git a/docs/angular/your-first-app/6-deploying-mobile.md b/docs/angular/your-first-app/6-deploying-mobile.md index 82e392c2e64..06ae7100d8f 100644 --- a/docs/angular/your-first-app/6-deploying-mobile.md +++ b/docs/angular/your-first-app/6-deploying-mobile.md @@ -60,7 +60,7 @@ ionic cap open ios In order for some native plugins to work, user permissions must be configured. In our photo gallery app, this includes the Camera plugin: iOS displays a modal dialog automatically after the first time that `Camera.getPhoto()` is called, prompting the user to allow the app to use the Camera. The permission that drives this is labeled “Privacy - Camera Usage.” To set it, the `Info.plist` file must be modified ([more details here](https://capacitorjs.com/docs/ios/configuration)). To access it, click "Info," then expand "Custom iOS Target Properties." -![Xcode Custom iOS Target Properties](/img/guides/first-app-cap-ng/xcode-info-plist.png) +![The Info.plist file in Xcode showing the NSCameraUsageDescription key added for camera access.](/img/guides/first-app-cap-ng/xcode-info-plist.png 'Xcode Info.plist Configuration') Each setting in `Info.plist` has a low-level parameter name and a high-level name. By default, the property list editor shows the high-level names, but it's often useful to switch to showing the raw, low-level names. To do this, right-click anywhere in the property list editor and toggle "Raw Keys/Values." @@ -70,15 +70,15 @@ Follow the same process to add the other two Keys required of the Camera plugin: Next, click on `App` in the Project Navigator on the left-hand side, then within the `Signing & Capabilities` section, select your Development Team. -![Xcode - Selecting Development Team](/img/guides/first-app-cap-ng/xcode-signing.png) +![The Xcode interface displaying the Signing and Capabilities tab for an iOS app project.](/img/guides/first-app-cap-ng/xcode-signing.png 'Xcode Signing & Capabilities') With permissions in place and Development Team selected, we are ready to try out the app on a real device! Connect an iOS device to your Mac computer, select it (`App -> Matthew’s iPhone` for me) then click the "Build" button to build, install, and launch the app on your device: -![Xcode build button](/img/guides/first-app-cap-ng/xcode-build-button.png) +![Xcode toolbar highlighting the Build button used to compile and run an iOS app.](/img/guides/first-app-cap-ng/xcode-build-button.png 'Xcode Build Button') Upon tapping the Camera button on the Photo Gallery tab, the permission prompt will display. Tap OK, then take a picture with the Camera. Afterward, the photo shows in the app! -![iOS Camera permissions](/img/guides/first-app-cap-ng/ios-permissions-photo.png) +![Two iPhones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/ios-permissions-photo.png 'iOS Camera Permission Prompt and Photo Result') ## Android Deployment @@ -92,7 +92,7 @@ ionic cap open android Similar to iOS, we must enable the correct permissions to use the Camera. Configure these in the `AndroidManifest.xml` file. Android Studio will likely open this file automatically, but in case it doesn't, locate it under `android/app/src/main/`. -![Android Manifest location](/img/guides/first-app-cap-ng/android-manifest.png) +![Android Studio editor showing the AndroidManifest.xml file with camera permissions.](/img/guides/first-app-cap-ng/android-manifest.png 'Android Manifest Permissions') Scroll to the `Permissions` section and ensure these entries are included: @@ -103,11 +103,11 @@ Scroll to the `Permissions` section and ensure these entries are included: Save the file. With permissions in place, we are ready to try out the app on a real device! Connect an Android device to your computer. Within Android Studio, click the "Run" button, select the attached Android device, then click OK to build, install, and launch the app on your device. -![Launching app on Android](/img/guides/first-app-cap-ng/android-device.png) +![The Android Studio interface with arrows pointing to the Run button and the connected device.](/img/guides/first-app-cap-ng/android-device.png 'Android Studio Run Configuration') Once again, upon tapping the Camera button on the Photo Gallery tab, the permission prompt should be displayed. Tap OK, then take a picture with the Camera. Afterward, the photo should appear in the app. -![Android Camera permissions](/img/guides/first-app-cap-ng/android-permissions-photo.png) +![Two Android phones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/android-permissions-photo.png 'Android Permissions and Photo Capture') Our Photo Gallery app has just been deployed to Android and iOS devices. 🎉 diff --git a/docs/core-concepts/webview.md b/docs/core-concepts/webview.md index 8c40ee79471..82259a9f82a 100644 --- a/docs/core-concepts/webview.md +++ b/docs/core-concepts/webview.md @@ -22,7 +22,7 @@ Ionic アプリは[Web 技術](../reference/glossary.md#web-standards)をつか 最近の Web View は、カメラ、センサー、GPS、スピーカー、Bluetooth などのハードウェア機能のための組み込みHTML5 APIsを多数提供していますが、プラットフォーム固有のハードウェア API にアクセスする必要がある場合もあります。Ionic アプリでは、通常は JavaScript API を利用してネイティブプラグインにアクセスしてブリッジする形でハードウェア API を利用することができます。 -![webview architecture](/img/building/webview-architecture.png) +![Diagram illustrating the architecture of a Web View in Ionic apps, showing the bridge between native app components and web components.](/img/building/webview-architecture.png 'Web View Architecture Diagram') Ionic Web View プラグインは、最新の JavaScript アプリケーションに特化しています。iOS と Android の両方で、アプリファイルは常に `http://` プロトコルを使ってデバイス上で動作する最適化された HTTP サーバーにホストされます。 @@ -47,4 +47,4 @@ Cordova アプリでは、[Ionic Web View plugin](https://github.com/ionic-team/ ### 実装 - **iOS**: WKWebView -- **Android**: Web View for Android +- **Android**: WebView for Android diff --git a/docs/deployment/play-store.mdx b/docs/deployment/play-store.mdx index f871fe34963..ce2dd35317e 100644 --- a/docs/deployment/play-store.mdx +++ b/docs/deployment/play-store.mdx @@ -69,15 +69,15 @@ If you haven't made the switch to Android app bundles yet, you will need to opt First, create a new app in the Google Play Console. In order to enable app signing, you'll need to navigate to the new release screen, on one of the Production, Open testing, closed testing, or internal testing pages. Select the Create new release button as seen below (it doesn't matter which release type, since you don't have to actually go through with creating a new release right now): -![Select create new release in Google Play Console's Production tab](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-release-1024x561.png) +![Google Play Console's Production tab with arrow pointing to the 'Create new release' button.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-release-1024x561.png "Google Play Console New Release Creation") Under the App integrity section, click the **Change app signing key** button: -![Select change app signing key in Google Play Console's Production tab](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-signingkey.png) +![Google Play Console's App integrity section with the 'Change app signing key' button highlighted.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-signingkey.png "Google Play Console Change App Signing Key Option") Next, select the **Export and upload a key from Java Keystore** option. This is the only way in which you can retain the key and have Google Play use it for signing. If you're using Appflow to build Android apps in the cloud, this is also the required option so you can upload the keystore file to Appflow. -![Uploading a keystore file to Google Play Console](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-export-1024x564.png) +![The Google Play Console showing the option to 'Export and upload a key from Java Keystore'.](https://blog.ionicframework.com/wp-content/uploads/2021/12/newapps-export-1024x564.png "Google Play Console Export and Upload Key Option") Follow the instructions on the screen to generate the Keystore and you can use the same Keystore file to sign your app in the Appflow dashboard as well. If you need any help generating the Keystore file, you can refer to our docs [here](https://ionic.io/docs/appflow/package/credentials#android-certificates). Once the generated zip file has been uploaded, you're all set! Build an AAB binary signed with the keystore file then upload it to Google Play. @@ -88,7 +88,7 @@ As of now, existing apps aren't required to use the AAB format, but you can stil To opt into app signing, you'll need to upload the app signing key used to sign previous releases of the app. Navigate to Setup -> App integrity, then choose one of the two methods seen in the screenshot below. Once the key has been uploaded, you can enroll in Play App Signing. -![App integrity setup in Google Play Console](https://blog.ionicframework.com/wp-content/uploads/2021/12/existingapps-optin.png) +![The opt-in options for Play App Signing in the Google Play Console.](https://blog.ionicframework.com/wp-content/uploads/2021/12/existingapps-optin.png "Google Play Console Opt-in to Play App Signing") :::tip With smaller app sizes, improved performance, and enhanced security, the AAB binary format is a win for app developers and users alike. If you have an existing Android app using the APK format, consider migrating to AAB to take advantage of all the great features it provides. @@ -140,7 +140,7 @@ Making a developer account with Google Play costs $25 USD. Once a developer account has been created, go ahead and click the `Create an Application` -![Create an App button](/img/publishing/newAppGPlay.png) +![The Google Play Store Developer Console with the 'CREATE APPLICATION' button highlighted.](/img/publishing/newAppGPlay.png "Google Play Store Create Application Button") Be sure to fill out the description for the app along with providing screenshots and additional info. When ready, upload the signed release AAB/APK that was generated and publish the app. diff --git a/docs/developer-resources/guides/first-app-v3/intro.md b/docs/developer-resources/guides/first-app-v3/intro.md index 844aef86a7e..4d44434249f 100644 --- a/docs/developer-resources/guides/first-app-v3/intro.md +++ b/docs/developer-resources/guides/first-app-v3/intro.md @@ -2,7 +2,7 @@ The great thing about Ionic is that with one codebase, you can build for any platform using familiar web tools and languages. Follow along as we create a working Photo Gallery. Here’s the before and after: -![Before and after going through this tutorial](/img/guides/first-app-v3/gallery-combined.png) +![An Ionic app's transformation from a blank 'Tab Two' to a 'Photo Gallery' with images.](/img/guides/first-app-v3/gallery-combined.png 'Ionic App Before and After Photo Gallery') It’s easy to get started. Reference code for this guide can be [found on GitHub](https://github.com/ionic-team/photo-gallery-tutorial-ionic3/). @@ -76,7 +76,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs: “Home”, “About”, and “Contact.” Click on the About tab. It’s a blank canvas, aka the perfect spot to add camera functionality. Let’s begin to transform the About page into a Photo Gallery. Ionic features LiveReload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-v3/email-photogallery.gif) +![Animated GIF demonstrating the LiveReload feature in Ionic, showing real-time updates in the app after code changes.](/img/guides/first-app-v3/email-photogallery.gif 'Ionic LiveReload Feature Demonstration') Open the photo-gallery app folder in your favorite code editor of choice, then navigate to `/src/pages/about/about.html`. We see: diff --git a/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md b/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md index da6f9462ecc..61d4605e865 100644 --- a/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md +++ b/docs/developer-resources/guides/first-app-v3/realtime-updates-ionic-deploy.md @@ -17,7 +17,7 @@ $ ionic cordova plugin add cordova-plugin-ionic@latest --save There are two unique values to provide: your app id and channel name. Sign into Appflow, then find the App Id on your app’s dashboard: -![app id location](/img/guides/first-app-v3/app-id-location.png) +![The location of the App ID in the Appflow dashboard.](/img/guides/first-app-v3/app-id-location.png 'Appflow App ID Location') And we’ll just use “Master” as the channel name. Putting this together looks like: @@ -168,7 +168,7 @@ $ git push ionic master Log into the [Appflow dashboard](https://dashboard.ionicframework.com) and navigate to Deploy -> Builds. You’ll see this newest commit begin to build immediately. Since we assigned the Appflow plugin to the Master branch (the one we always Git Push to), the Channel label will also point to this commit, effectively auto-deploying this change to all app users: -![deploy channel](/img/guides/first-app-v3/deploy-channel.png) +![The Deploy Builds section in the Appflow dashboard.](/img/guides/first-app-v3/deploy-channel.png 'Appflow Deploy Builds') A Channel points to a specific JavaScript Build or Snapshot of your app that will be shared with devices listening to that channel for updates. You can change which Build a Channel points to whenever you’d like. @@ -180,7 +180,7 @@ What if you deploy a change, then realize that there is a bug? Or perhaps you’ On the Deploy Builds page, click the “Assign to Channel” button on the previous commit, then click “Deploy.” App users will be reverted to the previous version, and our “Photo Gallery” name has been restored. -![deploy channel](/img/guides/first-app-v3/deploy-revertChange.png) +![The Deploy Builds section in Appflow with a commit labeled 'set name to Photo Gallery' being assigned to the master channel for rollback.](/img/guides/first-app-v3/deploy-revertChange.png 'Appflow Deploy Revert Change') This was just a taste of what you can do with Appflow Live Updates! You can also set up multiple deployment channels to send targeted updates to specific groups of users. Use it to run A/B tests, or target the distribution of updates by audience, geography, or test group. diff --git a/docs/developer-resources/guides/first-app-v3/theming.md b/docs/developer-resources/guides/first-app-v3/theming.md index 19ef3364069..077186843fc 100644 --- a/docs/developer-resources/guides/first-app-v3/theming.md +++ b/docs/developer-resources/guides/first-app-v3/theming.md @@ -4,11 +4,11 @@ Previously, we converted our single use Camera app into an epic photo gallery. N Ionic has five default colors, defined as Sass variables, that can be used to change the color of its UI components: -![v3-theming](/img/guides/first-app-v3/v3-theming.png) +![Ionic's default Sass color variables for theming: 'primary", secondary, danger, light, and dark.](/img/guides/first-app-v3/v3-theming.png 'Default Ionic Sass Variables') You can customize each color further by supplying a base and contract property. Base acts as the background color and contrast acts as the text color for most components. This provides much more flexible control over your styles: -![v3-theming-colors](/img/guides/first-app-v3/v3-themeColors.png) +![Code snippet showing customized Ionic Sass variables with additional twitter color base and contrast properties.](/img/guides/first-app-v3/v3-themeColors.png 'Customized Ionic Sass Variables') You can find these colors defined in `src/theme/variables.scss`. @@ -22,7 +22,7 @@ $colors: ( But wait, there’s more! Ionic automatically provides platform specific styles based on the device the application is running on, giving that native look and feel your users are used to: -![ios and android comparison](/img/guides/first-app-v3/ion-lab-comparison.png) +![Comparing the native look of an Ionic app on iOS and Android platforms.](/img/guides/first-app-v3/ion-lab-comparison.png 'Ionic Platform Specific Styles Comparison') In our app, this is clearly visible in how the header and the icons are styled. @@ -40,7 +40,7 @@ imports: [ Now, the iOS version of our app has a Material Design skin! -![ios and android comparison](/img/guides/first-app-v3/ion-lab-md-styling.png) +![An Ionic app with Material Design styling applied on an iOS device.](/img/guides/first-app-v3/ion-lab-md-styling.png 'Ionic Material Design Styling on iOS') Creating gorgeous-looking Ionic apps is easy with Sass variables and platform-specific styling. You now have everything you need to get started with Ionic. Go forth and build great apps! diff --git a/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md b/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md index c4fac8c2871..0417b953de6 100644 --- a/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md +++ b/docs/developer-resources/guides/first-app-v3/track-bugs-ionic-monitoring.md @@ -75,11 +75,11 @@ ionic serve Tap on the Gallery tab, then the camera button. A runtime error should occur. In a browser, head over to the [Appflow dashboard](https://dashboard.ionicframework.com), then Monitor -> Monitoring. After a few minutes, the error should appear: -![event monitoring](/img/guides/first-app-v3/monitoring-event.png) +![An event showing error 'takePhoto is not a function' with status 'New'.](/img/guides/first-app-v3/monitoring-event.png 'Ionic Monitoring Event Overview') Clicking on the event gives us lots of details surrounding what happened, such as a full stack trace. In this instance, we see that the error occurred three times on Mac OS X in the Chrome web browser. -![event details](/img/guides/first-app-v3/monitoring-details.png) +![Detailed view of an event log displaying a TypeError stack trace and error details such as device, browser, and operating system.](/img/guides/first-app-v3/monitoring-details.png 'Detailed Ionic Monitoring Event Log') Given the proliferation of mobile devices and operating systems these days, this is immensely powerful. Armed with these details, we can hone in on the problem and fix it quickly. diff --git a/docs/developer-resources/guides/first-app-v4/intro.md b/docs/developer-resources/guides/first-app-v4/intro.md index bffc7ea9c28..153afc5646f 100644 --- a/docs/developer-resources/guides/first-app-v4/intro.md +++ b/docs/developer-resources/guides/first-app-v4/intro.md @@ -2,7 +2,7 @@ The great thing about Ionic is that with one codebase, you can build for any platform using familiar web tools and languages. Follow along as we create a working Photo Gallery. Here’s the before and after: -![Before and after going through this tutorial](/img/guides/first-app-v3/gallery-combined.png) +![An Ionic app's transformation from a blank 'Tab Two' to a 'Photo Gallery' with images.](/img/guides/first-app-v3/gallery-combined.png 'Ionic App Before and After Photo Gallery') It’s easy to get started. Note that all code referenced in this guide can be [found on GitHub](https://github.com/ionic-team/photo-gallery-tutorial-ionic4/). @@ -65,7 +65,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to add camera functionality. Let’s begin to transform this page into a Photo Gallery. Ionic features LiveReload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/first-app-v3/email-photogallery.gif) +![Animated GIF demonstrating the LiveReload feature in Ionic, showing real-time updates in the app after code changes.](/img/guides/first-app-v3/email-photogallery.gif 'Ionic LiveReload Feature Demonstration') Open the photo-gallery app folder in your favorite code editor of choice, then navigate to `/src/app/tab2/tab2.page.html`. We see: diff --git a/docs/developer-resources/guides/first-app-v4/theming.md b/docs/developer-resources/guides/first-app-v4/theming.md index 140d3aef091..e2263fdc548 100644 --- a/docs/developer-resources/guides/first-app-v4/theming.md +++ b/docs/developer-resources/guides/first-app-v4/theming.md @@ -4,11 +4,11 @@ Ionic には CSS 変数として定義された 9 つのデフォルトカラーがあり、UI コンポーネントのカラーを変更するために使用できます: -![v4-theming-defaults](/img/guides/first-app-v4/theming-defaults.png) +![A chart showing Ionic's nine default colors with their hex codes.](/img/guides/first-app-v4/theming-defaults.png 'Ionic Default Color Palette') base、contrast、shade、tint プロパティを指定することによって、各カラーをさらにカスタマイズできます。これらにより、スタイルを柔軟にコントロールできます: -![v4-theming-properties](/img/guides/first-app-v4/theming-properties.png) +![Table detailing the properties for customizing the primary color in Ionic, including base, contrast, shade, and tint.](/img/guides/first-app-v4/theming-properties.png 'Ionic Color Customization Properties') これらのカラーは `src/theme/variables.scss` 内に定義されていることがわかります。 @@ -31,7 +31,7 @@ base、contrast、shade、tint プロパティを指定することによって しかし待ってください、まだあります！Ionic は、アプリケーションが実行されているデバイスに基づいて、プラットフォーム固有のスタイルを自動的に提供し、ユーザーが慣れているネイティブなルック・アンド・フィールを与えます: -![ios and android comparison](/img/guides/first-app-v3/ion-lab-comparison.png) +![Comparing the native look of an Ionic app on iOS and Android platforms.](/img/guides/first-app-v3/ion-lab-comparison.png 'Ionic Platform Specific Styles Comparison') 私たちのアプリでは、これはヘッダーとアイコンがどのようにスタイルされているかで、はっきりと見えます。 @@ -49,7 +49,7 @@ imports: [ これで、iOS 版のアプリにマテリアルデザインのスキンが追加されました！ -![ios and android comparison](/img/guides/first-app-v3/ion-lab-md-styling.png) +![An Ionic app with Material Design styling applied on an iOS device.](/img/guides/first-app-v3/ion-lab-md-styling.png 'Ionic Material Design Styling on iOS') CSS 変数とプラットフォーム固有のスタイルを使用すれば、とても魅力的な Ionic アプリケーションを簡単に作成できます。これで、Ionic を使い始めるために必要なものがすべて揃いました。 diff --git a/docs/developing/tips.md b/docs/developing/tips.md index 141b2ae509a..d883bba69cd 100644 --- a/docs/developing/tips.md +++ b/docs/developing/tips.md @@ -122,7 +122,7 @@ function myBrokenFunction() { しかし、どのプラットフォームが現在使用されているかをブラウザがどのように認識するか、ということは変わらないでしょう。プラットフォームはデバイスの検出とユーザーエージェントの検査によって決定されます。そのため、プラットフォームを変更するには、ユーザーエージェントを変更する必要があります。これを行うには、Chrome DevTools を開き、Ctrl+Shift+i(Mac では Cmd+Option+I) でデバイスのモードをオンに切り替えでください。デバイスモードの切り替えは、Ctrl+Shift+M(Cmd+Option+M on Mac)で行います。 ::: -![別のモードのアプリケーション](/img/faq/tips/change-device-platform.png) +![Chrome DevTools showing the device mode with iPhone X selected.](/img/faq/tips/change-device-platform.png 'Chrome DevTools Device Mode') デバイスのドロップダウンからデバイスを選択すると viewport の大きさと同様に、ユーザーエージェントも変更されます。 diff --git a/docs/intro/cli.md b/docs/intro/cli.md index 3ee3bd82f49..1ee4b5d88a9 100644 --- a/docs/intro/cli.md +++ b/docs/intro/cli.md @@ -48,7 +48,7 @@ Ionic アプリを作成するには、スターターテンプレートを利 ionic start ``` -![start app thumbnails](/img/installation/start-app-thumbnails.png) +![Three thumbnail previews of Ionic app templates: blank, tabs, and side menu.](/img/installation/start-app-thumbnails.png 'Ionic App Starter Templates') Ionic アプリのはじめ方をもっと知りたい方は、[スタートガイド](../developing/starting.md)を参照してください。 diff --git a/docs/react/quickstart.md b/docs/react/quickstart.md index 39cfc4887e1..fc11d62fed2 100644 --- a/docs/react/quickstart.md +++ b/docs/react/quickstart.md @@ -127,7 +127,7 @@ const App: React.FC = () => ( 現在、 `Home` コンポーネントはこうなっています: -![React home component](/img/guides/react/first-app/home-route.png) +![The Home component displayed in a web browser with the text 'The world is your oyster'.](/img/guides/react/first-app/home-route.png 'Ionic React Home Component') ```tsx import { IonContent, IonHeader, IonPage, IonTitle, IonToolbar } from '@ionic/react'; diff --git a/docs/react/your-first-app.md b/docs/react/your-first-app.md index bdc666886e7..003077cc632 100644 --- a/docs/react/your-first-app.md +++ b/docs/react/your-first-app.md @@ -124,7 +124,7 @@ And voilà! Your Ionic app is now running in a web browser. Most of your app can There are three tabs. Click on the Tab2 tab. It’s a blank canvas, aka the perfect spot to transform into a Photo Gallery. The Ionic CLI features Live Reload, so when you make changes and save them, the app is updated immediately! -![Before and after going through this tutorial](/img/guides/react/first-app/live-reload.gif) +![Animated GIF showing the live reload feature in an Ionic app, with changes in code immediately updating the app in a web browser.](/img/guides/react/first-app/live-reload.gif 'Live Reload Feature in Ionic App') Open `/src/pages/Tab2.tsx`. We see: diff --git a/docs/react/your-first-app/2-taking-photos.md b/docs/react/your-first-app/2-taking-photos.md index 5b76b46e0b1..ed60a7d1dbf 100644 --- a/docs/react/your-first-app/2-taking-photos.md +++ b/docs/react/your-first-app/2-taking-photos.md @@ -72,7 +72,7 @@ const Tab2: React.FC = () => { Save the file, and if you’re not already, restart the development server in your browser by running `ionic serve`. On the Photo Gallery tab, click the Camera button. If your computer has a webcam of any sort, a modal window appears. Take a selfie! -![Camera API on the web](/img/guides/first-app-cap-ng/camera-web.png) +![A photo gallery app displaying a webcam selfie.](/img/guides/first-app-cap-ng/camera-web.png 'Webcam Selfie in Photo Gallery') _(Your selfie is probably much better than mine)_ diff --git a/docs/react/your-first-app/6-deploying-mobile.md b/docs/react/your-first-app/6-deploying-mobile.md index eb5cf411a1e..64089e7621e 100644 --- a/docs/react/your-first-app/6-deploying-mobile.md +++ b/docs/react/your-first-app/6-deploying-mobile.md @@ -53,7 +53,7 @@ ionic cap open ios In order for some native plugins to work, user permissions must be configured. In our photo gallery app, this includes the Camera plugin: iOS displays a modal dialog automatically after the first time that `Camera.getPhoto()` is called, prompting the user to allow the app to use the Camera. The permission that drives this is labeled “Privacy - Camera Usage.” To set it, the `Info.plist` file must be modified ([more details here](https://capacitorjs.com/docs/ios/configuration)). To access it, click "Info," then expand "Custom iOS Target Properties." -![Xcode Custom iOS Target Properties](/img/guides/first-app-cap-ng/xcode-info-plist.png) +![The Info.plist file in Xcode showing the NSCameraUsageDescription key added for camera access.](/img/guides/first-app-cap-ng/xcode-info-plist.png 'Xcode Info.plist Configuration') Each setting in `Info.plist` has a low-level parameter name and a high-level name. By default, the property list editor shows the high-level names, but it's often useful to switch to showing the raw, low-level names. To do this, right-click anywhere in the property list editor and toggle "Raw Keys/Values." @@ -63,15 +63,15 @@ Follow the same process to add the other two Keys required of the Camera plugin: Next, click on `App` in the Project Navigator on the left-hand side, then within the `Signing & Capabilities` section, select your Development Team. -![Xcode - Selecting Development Team](/img/guides/first-app-cap-ng/xcode-signing.png) +![The Xcode interface displaying the Signing and Capabilities tab for an iOS app project.](/img/guides/first-app-cap-ng/xcode-signing.png 'Xcode Signing & Capabilities') With permissions in place and Development Team selected, we are ready to try out the app on a real device! Connect an iOS device to your Mac computer, select it (`App -> Matthew’s iPhone` for me) then click the "Build" button to build, install, and launch the app on your device: -![Xcode build button](/img/guides/first-app-cap-ng/xcode-build-button.png) +![Xcode toolbar highlighting the Build button used to compile and run an iOS app.](/img/guides/first-app-cap-ng/xcode-build-button.png 'Xcode Build Button') Upon tapping the Camera button on the Photo Gallery tab, the permission prompt will display. Tap OK, then take a picture with the Camera. Afterward, the photo shows in the app! -![iOS Camera permissions](/img/guides/first-app-cap-ng/ios-permissions-photo.png) +![Two iPhones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/ios-permissions-photo.png 'iOS Camera Permission Prompt and Photo Result') ## Android @@ -85,7 +85,7 @@ ionic cap open android Similar to iOS, we must enable the correct permissions to use the Camera. Configure these in the `AndroidManifest.xml` file. Android Studio will likely open this file automatically, but in case it doesn't, locate it under `android/app/src/main/`. -![Android Manifest location](/img/guides/first-app-cap-ng/android-manifest.png) +![Android Studio editor showing the AndroidManifest.xml file with camera permissions.](/img/guides/first-app-cap-ng/android-manifest.png 'Android Manifest Permissions') Scroll to the `Permissions` section and ensure these entries are included: @@ -96,11 +96,11 @@ Scroll to the `Permissions` section and ensure these entries are included: Save the file. With permissions in place, we are ready to try out the app on a real device! Connect an Android device to your computer. Within Android Studio, click the "Run" button, select the attached Android device, then click OK to build, install, and launch the app on your device. -![Launching app on Android](/img/guides/first-app-cap-ng/android-device.png) +![The Android Studio interface with arrows pointing to the Run button and the connected device.](/img/guides/first-app-cap-ng/android-device.png 'Android Studio Run Configuration') Once again, upon tapping the Camera button on the Photo Gallery tab, the permission prompt should be displayed. Tap OK, then take a picture with the Camera. Afterward, the photo should appear in the app. -![Android Camera permissions](/img/guides/first-app-cap-ng/android-permissions-photo.png) +![Two Android phones side by side, one showing the camera permission prompt and the other displaying a photo taken with the app.](/img/guides/first-app-cap-ng/android-permissions-photo.png 'Android Permissions and Photo Capture') Our Photo Gallery app has just been deployed to Android and iOS devices. 🎉 diff --git a/docs/reference/support.md b/docs/reference/support.md index 20600f1f842..d599b2b39fc 100644 --- a/docs/reference/support.md +++ b/docs/reference/support.md @@ -20,16 +20,16 @@ Given the reality of time and resource constraints as well as the desire to keep The current status of each Ionic Framework version is: -| Version | Status | Released | Maintenance Ends | Ext. Support Ends | -| :-----: | :--------------: | :----------: | :--------------: | :---------------: | -| V8 | Pre-Release | TBD | TBD | TBD | -| V7 | **Active** | Mar 29, 2023 | TBD | TBD | -| V6 | Extended Support | Dec 8, 2021 | Sep 29, 2023 | Mar 29, 2024 | -| V5 | End of Support | Feb 11, 2020 | June 8, 2022 | Dec 8, 2022 | -| V4 | End of Support | Jan 23, 2019 | Aug 11, 2020 | Sept 30, 2022 | -| V3 | End of Support | Apr 5, 2017 | Oct 30, 2019 | Aug 11, 2020 | -| V2 | End of Support | Jan 25, 2017 | Apr 5, 2017 | Apr 5, 2017 | -| V1 | End of Support | May 12, 2015 | Jan 25, 2017 | Jan 25, 2017 | +| Version | Status | Released | Maintenance Ends | Ext. Support Ends | +| :-----: | :------------: | :----------: | :--------------: | :---------------: | +| V8 | **Active** | Apr 17, 2024 | TBD | TBD | +| V7 | Maintenance | Mar 29, 2023 | Oct 17, 2024 | Apr 17, 2025 | +| V6 | End of Support | Dec 8, 2021 | Sep 29, 2023 | Mar 29, 2024 | +| V5 | End of Support | Feb 11, 2020 | June 8, 2022 | Dec 8, 2022 | +| V4 | End of Support | Jan 23, 2019 | Aug 11, 2020 | Sept 30, 2022 | +| V3 | End of Support | Apr 5, 2017 | Oct 30, 2019 | Aug 11, 2020 | +| V2 | End of Support | Jan 25, 2017 | Apr 5, 2017 | Apr 5, 2017 | +| V1 | End of Support | May 12, 2015 | Jan 25, 2017 | Jan 25, 2017 | - **Maintenance**: Only critical bug and security fixes. No major feature improvements. - **Extended Support**: For teams and organizations that require additional long term maintenance support, Ionic has extended support options available. To learn more, see our [Enterprise offerings](https://ionicframework.com/enterprise). diff --git a/docs/theming/advanced.md b/docs/theming/advanced.md index 562dd298a0f..6aca26f34c2 100644 --- a/docs/theming/advanced.md +++ b/docs/theming/advanced.md @@ -32,9 +32,9 @@ CSS ベースのテーマ設定では、CSS ファイルをロードするか、 ``` -| Light Mode | Dark Mode | -| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| ![Application with theme-color meta in light mode](/img/theming/theme-color-light.png) | ![Application with theme-color meta in dark mode](/img/theming/theme-color-dark.png) | +| Light Mode | Dark Mode | +| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | +| ![The light mode theme color in a browser interface.](/img/theming/theme-color-light.png 'Light Mode Theme Color') | ![The dark mode theme color in a browser interface.](/img/theming/theme-color-dark.png 'Dark Mode Theme Color') | macOS Monterey 以降の Safari では、`theme-color`メタを使用してツールバーをカスタマイズすることもできます。 diff --git a/docs/theming/dark-mode.md b/docs/theming/dark-mode.md index a7b17f7c012..b2cc7fd5d52 100644 --- a/docs/theming/dark-mode.md +++ b/docs/theming/dark-mode.md @@ -192,11 +192,11 @@ The `.ion-palette-dark` class **must** be added to the `html` element in order t color-scheme: light dark; ``` -| Default scrollbar | Scrollbar with `color-scheme` | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------- | -| ![Application without color-scheme](/img/theming/color-scheme-light.png) | ![Application with color-scheme](/img/theming/color-scheme-dark.png) | +| Default scrollbar | Scrollbar with `color-scheme` | +| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ![A default light-themed scrollbar in an application interface.](/img/theming/color-scheme-light.png 'Default scrollbar appearance without dark mode') | ![A dark-themed scrollbar in an application interface, demonstrating the effect of the 'color-scheme' property.](/img/theming/color-scheme-dark.png "Scrollbar appearance with dark mode 'color-scheme' applied") | -より詳しい `color-scheme` の情報については https://web.dev/color-scheme/ をご覧ください。 +`color-scheme` に関する詳細は、[Web.dev guide on color schemes](https://web.dev/color-scheme/)を参照してください。 :::note `color-scheme` はキーボードに反映されません。キーボードのダークモードについての詳しい情報は [Keyboard Documentation](../developing/keyboard.md#dark-mode) をご覧ください。 @@ -227,7 +227,7 @@ It is important to pay attention to the specificity if you want to override any ::: :::info -The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **always** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.always.scss). +The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **always** dark palette can be found in the [repository](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.always.scss). ::: @@ -246,7 +246,7 @@ It is important to pay attention to the specificity if you want to override any ::: :::info -The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **system** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.system.scss). +The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **system** dark palette can be found in the [repository](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.system.scsss). ::: @@ -264,7 +264,7 @@ It is important to pay attention to the specificity if you want to override any ::: :::info -The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **class** dark palette can be found [here](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.class.scss). +The contents of Ionic's dark palette can be [viewed on GitHub](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.scss). The CSS used to apply the **class** dark palette can be found in the [repository](https://github.com/ionic-team/ionic-framework/blob/main/core/src/css/palettes/dark.class.scss). ::: diff --git a/docs/troubleshooting/native.md b/docs/troubleshooting/native.md index fbc77686159..865c60ef0f2 100644 --- a/docs/troubleshooting/native.md +++ b/docs/troubleshooting/native.md @@ -38,12 +38,12 @@ iOS デバイスでアプリケーションを実行するには、プロビジ 3. プロジェクト ナビゲーターで、プロジェクトのルートを選択しエディタでプロジェクトを開きます。 **Identity** セクションで、設定された Package ID がバンドル識別子と一致することを確認します。 - ![Xcode Identity Setup](/img/running/ios-xcode-identity-setup.png) + ![Xcode showing the Identity section for an iOS app with fields for Display Name, Bundle Identifier, Version, and Build.](/img/running/ios-xcode-identity-setup.png "Xcode Identity Section") 4. 同じプロジェクトエディタの 署名 セクションで、Automatically manage signing が 有効になっていることを確認します。 次に、Team から開発チームを選択します。開発チームがあれば、Xcode は プロビジョニングと署名を自動的に準備しようとします。 - ![Xcode Signing Setup](/img/running/ios-xcode-signing-setup.png) + ![Xcode showing the Signing section with 'Automatically manage signing' enabled and a Development Team selected.](/img/running/ios-xcode-signing-setup.png "Xcode Signing Section") ## Xcode のビルドエラー 65 diff --git a/docs/vue/quickstart.md b/docs/vue/quickstart.md index 2866f9b104f..f0fb3103c36 100644 --- a/docs/vue/quickstart.md +++ b/docs/vue/quickstart.md @@ -191,7 +191,7 @@ Now, you might be wondering: Why do we use `@` when describing the path to our c 現在、 `Home` コンポーネントはこうなっています: -![Vue home component](/img/guides/vue/first-app/home-route.png) +![A web browser displaying the Ionic Vue home route with a header titled 'Blank' and a message 'Ready to create an app? Start with Ionic UI Components'.](/img/guides/vue/first-app/home-route.png 'Ionic Vue Home Route Interface') ```html